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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-0464,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


ROLE 


Control  Data  Corporation 


D.  Appleton  Company 


ONTEK 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFlX  integration 
methodology . 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 

Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 


SCOPE 


Identification 


—j  This  specification  establishes  the  performance,  development, 
test,  and  qualification  requirements  of  the  Virtual  Terminal 
protocol  and  the  computer  programs  implementing  it  (the  Virtual 
Terminal  software) .  The  Virtual  Terminal  is  one  configuration 
item  of  the  Integrated  Information  Support  System  User  Interface. 


1 . 2  Functional  Summary 


One  of  the  objectives  of  the  Integrated  Information  Support 
System  is  to  allow  applications  to  be  run  from  a  wide  variety  of 
terminals.  Instead  of  having  to  worry  about  device  specific 
commands  to  perform  a  specific  function  on  a  particular  type  of 
terminal,  an  application  instead  uses  the  Virtual  Terminal 
protocol.  The  Virtual  Terminal  protocol  is  defined  in  terms  of 
the  set  of  functions  which  it  can  perform,  the  set  of  attributes 
that  it  supports,  and  the  commands  for  invoking  these  functions. 


The  Virtual  Terminal  software  translates  between  the  Virtual 
Terminal  commands  and  commands  for  the  particular  type  of  terminal 
a  user  has.  Since  most  terminals  do  not  provide  all  of  the 
functions  and  attributes  that  the  Virtual  Terminal  does,  the 
Virtual  Terminal  software  must  be  able  to  simulate  missing 
functions  using  only  existing  ones. 


In  addition  to  supporting  terminals,  the  Virtual  Terminal 
software  also  performs  another  function  —  interfacing  existing 
applications  into  IISS.  An  existing  application  sends  (and 
expects  to  receive)  commands  for  a  particular  type  of  terminal. 

In  IISS  these  commands  are  intercepted  and  sent  to  the  Virtual 
Terminal  software  which  then  converts  the  commands  into  Virtual 
Terminal  commands,  just  as  if  they  had  been  entered  from  a 
terminal.  Similarly,  it  converts  Virtual  Terminal  commands  to  the 
specific  terminal  commands  the  application  expects  to  receive. 

This  allows  an  existing  application  to  be  run  from  a  type  of 
terminal  other  than  the  one  it  was  designed  for. 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 

[1]  American  National  Standards  Institute,  Coded  Character  Sets  - 

7 - Bit  American  National  Standard  Code  for  Information 
Interchange  (7-Bit  ASCII),  ANSI  X3. 4-1986,  26  March  1986. 

[2]  American  National  Standards  Institute,  Code  Extension 
Technigues  for  Use  with  the  7-Bit  Coded  Character  Set  of 
American  National  Standard  Code  for  Information  Interchange, 
ANSI  X3. 41-1974,  14  May  1974. 

[3]  American  National  Standards  Institute,  Additional  Controls 
for  Use  with  American  National  Standard  Code  for  Information 
Interchange,  ANSI  X3. 64-1979,  18  July  1979. 

r41  American  National  Standards  Institute,  Hollerith  Punched  Card 
Code,  ANSI  X3. 26-1980,  2  May  1980. 

[5]  International  Organization  for  Standardization,  Information 
Processing  -  ISO  7-Bit  Character  Set  for  Information 
Interchange,  ISO  646-1983. 

[6]  International  Organization  for  Standardization,  ISO  7-Bit  and 

8- Bit  Coded  Character  Sets  -  Code  Extension  Technigues,  ISO 
2022-1982. 

[7]  International  Organization  for  Standardization,  ISO  7-Bit  and 
8-Bit  Coded  Character  Sets  -  Additional  Control  Functions  for 
Character  -  Imaging  Devices,  ISO  6429-1983. 

[8]  ICAM  Documentation  Standards,  IDS150120000C,  15  September 
1983. 

[9]  Structural  Dynamics  Research  Corporation,  IISS  Terminal 
Operator  Guide,  OM  620144000,  1  November  1985. 

[10]  Structural  Dynamics  Research  Corporation,  Form  Processor 
Development  Specification,  DS  620144200B,  1  November  1985. 

[11]  Structural  Dynamics  Research  Corporation,  IISS  Form  Processor 
User  Manual,  UM  620144200B,  1  November  1985. 

[12]  Structural  Dynamics  Research  Corporation,  Virtual  Terminal 
User  Manual,  UM  620144300B,  1  November  1985. 

[13]  Structural  Dynamics  Research  Corporation,  Application 
Interface  Development  Specification,  DS  620144700,  1  November 
1985. 

[14]  Boeing  Military  Airplane  Company,  NTM  Programmer ' s  Manual , 
PRM620242000,  20  July  1987. 
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2 . 2  Terms  and  Abbreviations 
AI ;  Application  Interface. 

American  Standard  Code  for  Information  Interchange;  the  character 
set  defined  by  ANSI  X3.4  and  used  by  most  computer  vendors. 

AP:  Application  Process. 

Application  Interface;  subset  of  the  IISS  User  Interface  that 
consists  of  the  callable  routines  that  are  linked  with 
applications  that  use  the  Form  Processor  or  Virtual  Terminal.  The 
Application  Interface  enables  applications  to  be  hosted  on 
computers  other  than  the  host  of  the  User  Interface. 

Application  Process;  a  cohesive  unit  of  software  that  can  be 
initiated  as  a  unit  to  perform  some  function  or  functions. 

ASCII ;  American  Standard  Code  for  Information  Interchange. 

Attention  Interrupt:  an  asynchronous  signal  usually  generated  by 
pressing  a  special  key  or  combination  of  keys  which  indicates  that 
the  currently  executing  program  should  be  stopped. 

Attribute;  visual  and  logical  characteristics  (e.g.  blinking, 
highlighted,  enterable) . 

Block  Mode;  a  mode  of  interaction  in  which  a  device  does  not  send 
characters  as  they  are  entered  but  waits  for  some  triggering  event 
to  send  an  entire  block  of  characters. 

Character  Set;  the  characters  used  by  a  computer  system  and  the 
bit  patterns  assigned  to  represent  them. 

Class  Routines;  routines  which  are  common  to  a  number  of  systems 
or  devices. 

Computer  Program  Configuration  Item;  an  aggregation  of  computer 
programs  or  any  of  their  discrete  portions,  which  satisfies  an 
end-use  function. 

Control  Character;  a  control  function  which  is  coded  as  a  single 
character. 

Control  Function ;  an  action  that  affects  the  recording, 
processing,  transmission,  or  interpretation  of  data. 

Control  Sequence;  a  sequence  of  characters  beginning  with  the 
Control  Sequence  Introducer  control  function  which  represents  a 
control  function. 

Control  String ;  a  sequence  of  characters  beginning  and  ending  with 
a  delimiting  control  function  which  represents  a  control  function. 

CPCI ;  Computer  Program  Configuration  Item. 

DD;  Device  Driver. 
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Device  Driver:  software  which  handles  input  and  output  for  a 
specific  kind  of  terminal  by  mapping  between  terminal  specific 
commands  and  Virtual  Terminal  commands. 

Device  Routines:  routines  which  are  specific  to  a  particular  type 
of  terminal. 

EBCDIC:  Extended  Binary  Coded  Decimal  Interchange  Code. 

Escape  Sequence;  a  sequence  of  characters  beginning  with  the 
Escape  control  character  which  represent  a  control  function. 

Extended  Binary  Coded  Decimal  Interchange  Code:  the  character  set 
used  by  a  few  computer  vendors  (notably  IBM)  instead  of  ASCII. 

Field;  two  dimensional  space  on  a  terminal  screen  which  contains 
data . 

Fill  Area:  a  polygonal  area  the  interior  of  which  is  filled-in  in 
some  fashion. 

Host ;  a  computer  system  running  the  Integrated  Information  Support 
System. 

IISS ;  Integrated  Information  Support  System. 

Integrated  Information  Support  System;  a  test  computing 
environment  used  to  investigate,  demonstrate  and  test  the  concepts 
of  information  management  and  information  integration  in  the 
context  of  Aerospace  Manufacturing.  IISS  addresses  the  problems 
of  integration  of  data  resident  on  heterogeneous  databases 
supported  by  heterogeneous  computers  interconnected  via  a  local 
area  network. 

Line:  a  group  of  points  which  are  connected  in  the  order 
specified. 

Marker;  a  group  of  points  the  locations  of  which  are  indicated  by 
a  symbol . 

Master  Mode;  the  mode  of  operation  used  by  a  Device  Driver  which 
IS  started  by  a  user  using  host  operating  system  commands  in  order 
to  connect  into  IISS. 

Network  Transaction  Manager;  IISS  subsystem  that  performs  the 
coordination,  communication,  and  housekeeping  functions  required 
to  integrate  the  Application  Processes  and  System  Services 
resident  on  the  various  hosts  into  a  cohesive  system. 

NTM;  Network  Transaction  Manager. 

Numeric  Parameter:  a  parameter  which  represents  a  numeric  value. 

Operating  System;  software  supplied  with  a  computer  which  allows 
it  to  supervise  its  own  operations  and  manage  access  to  hardware 
facilities  such  as  memory  and  peripherals. 
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Physical  Device:  a  hardware  terminal - 

Primitive:  a  graphic  element  contained  in  a  view.  Either  a  fi"'! 
area,  line,  marker,  or  text. 

Script  File:  a  file  containing  Virtual  Terminal  commands  which  can 
be  replayed  to  duplicate  the  session  during  which  it  was  recorded. 

Selective  Parameter:  a  parameter  which  is  used  to  represent 
selections  from  a  list  of  possible  values. 

Slave  Mode:  the  mode  of  operation  used  by  a  Device  Driver  which  is 
started  by  the  User  Interface. 

Software  Control  String:  a  control  string  which  is  intended  co  be 
used  to  control  software  as  opposed  to  hardware. 

System  Routines:  routines  which  are  specific  to  a  particular 
computer  system  or  operating  system. 

Text:  a  prim:..tive  consisting  sequence  of  characters  the  size, 
color,  orientation,  and  location  of  which  may  be  specified. 

UI ;  User  Interface. 

UIM:  User  Interface  Monitor. 

UIMS:  User  Interface  Management  System. 

User  Interface :  IISS  subsystem  that  controls  the  user's  terminal 
and  interfaces  with  the  rest  of  the  system.  The  UI  consists  of 
two  major  subsystems:  the  User  Interface  Development  System  and 
the  User  Interface  Management  System. 

View:  an  area  of  the  screen  which  can  contain  primitives. 

Virtual  Terminal:  subset  of  the  IISS  User  Interface  that  performs 
the  interfacing  between  different  terminals  and  the  Ui.  This  is 
done  by  defining  a  specific  set  of  terminal  features  and  protocols 
which  must  be  supported  by  the  UI  software  which  constitutes  the 
virtual  terminal  definition.  Specific  terminals  are  then  mapped 
against  the  virtual  terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 

Virtual  Terminal  Interface:  the  callable  interface  to  the  Virtual 
Terminal . 

VT;  Virtual  Terminal. 

VTI :  Virtual  Terminal  Interface. 

Window:  an  area  of  the  screen  which  an  contain  other  windows  (sub¬ 
windows)  ,  fields,  and  views. 
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Window  Manager ;  a  facility  which  allows  the  following  to  be 
manipulated:  size  and  location  of  windows,  the  device  on  which 
application  is  running,  the  position  of  a  form  within  a  window 
It  is  part  of  the  Form  Processor. 
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SECTION  3 
REQUIREMENTS 


3 . 1  Computer  Program  Definition 

The  Virtual  Terminal  protocol  and  software  allow  Integrated 
Information  Support  System  applications  to  run  on  a  wide  variety 
of  physical  devices  (terminals) .  The  Virtual  Terminal  protocol 
defines  the  available  functions  and  attributes  and  the  Virtual 
Terminal  software  translates  between  the  Virtual  Terminal  protocol 
and  commands  for  a  particular  type  of  terminal.  An  implementation 
of  the  Virtual  Terminal  software  for  a  specific  operating  system 
and  terminal  type  is  referred  to  as  a  Device  Driver. 


3.1.1  System  Capacities 

A  Device  Driver  is  required  to  handle  only  a  single  terminal 
as  there  will  be  a  separate  instance  of  the  software  for  each 
active  terminal.  Dynamic  memory  allocation  will  be  used  to  avoid 
any  artificial  limitations  on  screen  size  or  image  complexity. 


3.1.2  Interface  Requirements 

A  Device  Driver  has  direct  interfaces  with  the  Network 
Transaction  Manager  and  the  host  operating  system.  It  has 
indirect  interfaces  with  the  User  Interface,  a  physical  terminal, 
application  programs,  and  the  user  of  the  terminal. 

The  interface  between  a  Device  Driver  and  the  User  Interface 
is  provided  by  Network  Transaction  Manager  messages  which  are  sent 
and  received  using  the  standard  NTM  Services  defined  in  [14].  The 
interface  between  a  Device  Driver  and  application  programs  is  also 
provided  by  NTM  messages  which  are  initially  generated  by  Virtual 
Terminal  Services  which  are  part  of  the  Application  Interface 
[13].  These  messages  are  routed  through  the  User  Interface  which 
reformats  them  as  required  before  sending  them  on  to  their 
ultimate  destination. 

The  content  of  these  messages  is  specified  by  the  Virtual 
Terminal  protocol  as  defined  in  section  3. 1.2. 2. 5.  The  protocol 
is  to  conform  to  existing  national  and  international  standards 
[1],  [2],  [3],  [4],  [5],  [6],  and  [7].  Although  these  standards 

are  defined  in  terms  of  a  standard  character  set,  the  Virtual 
Terminal  protocol  will  be  represented  using  the  native  character 
set  of  the  host  machine  (character  set  conversion  is  provided  by 
the  Network  Transaction  Manager) .  Character  set  mappings  for  the 
most  common  character  sets  are  provided  in  Appendix  B. 

The  interface  between  the  Virtual  Terminal  software  and  a 
physical  terminal  is  provided  by  the  host  operating  system.  The 
actual  mechanism  for  sending  and  receiving  terminal  data  is  thus 
system  specific,  and  the  format  of  the  data  is  device  specific. 
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3. 1.2.1  Interface  Block  Diagram 

The  Virtual  Terminal  structure  and  interfaces  are  depicted 
graphically  in  Figure  3-1.  Boxes  represent  processes  and  arrows 
represent  NTM  messages.  Divisions  within  a  box  indicate  separate 
subsystems . 
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Figure  3-1  Virtual  Terminal  Interfaces 
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3. 1.2. 2  Detailed  Interface  Definition 

Device  Drivers  are  operated  in  one  of  two  modes:  master  and 
slave.  Master  mode  is  used  when  a  Device  Driver  is  initiated  by  a 
user  in  order  to  connect  to  the  Integrated  Information  Support 
System.  This  is  done  using  host  operating  system  commands  and 
results  in  the  Device  Driver  being  connected  to  the  user's 
terminal.  Slave  mode  is  used  when  a  Device  Driver  is  initiated  by 
the  User  Interface  in  response  to  a  connected  user's  request  to 
use  an  additional  device.  This  is  done  using  an  NTM  message  and 
results  in  the  Device  Driver  being  connected  to  the  device 
specified  in  the  message.  These  modes  will  not  be  mentioned 
except  where  there  are  differences  between  them. 
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3. 1.2.2. 1  Physical  Terminal 

As  noted  before,  the  interface  to  a  physical  terminal  is 
provided  by  host  operating  system  services  and  is  thus  both  system 
and  device  dependent. 


3. 1.2. 2. 2  User  Interface 

The  interface  to  the  User  Interface  is  provided  by  NTM 
messages  the  types  and  interpretations  of  which  are  defined  in  the 
following  sections.  The  Virtual  Terminal  commands  contained  in 
these  messages  are  defined  by  the  Virtual  Terminal  protocol  in 
section  3. 1.2. 2. 5.  This  interface  is  a  block  mode  interface; 
characters  are  received  from  the  terminal  in  a  block  rather  than 
one  at  a  time.  Transmission  is  triggered  when  the  user  presses  a 
function  key. 


3. 1.2. 2. 2.1  Master  Mode  Device  Driver  Messages 
Received  Messages 

SD  Shutdown  -  Terminate  Device  Driver. 

DD  Device  Data  -  Process  Virtual  Terminal  commands 
contained  in  message. 

DQ  Device  Query  -  Process  Virtual  Terminal  commands 

contained  in  message  and  respond  with  an  acknowledgment 
when  finished. 

SE  Signal  Error  -  Forward  message  to  User  Interface 
Monitor. 

UL  User  Logon  -  Perform  NTM  Logon  with  parameters  contained 
in  message. 

UC  User  Change  Role  -  Perform  NTM  Change  Role  with 
parameters  contained  in  message. 


Sent  Messages 

DD  Device  Data  -  Sent  when  the  user  presses  a  function  key 
-  Contains  Virtual  Terminal  commands  for  user  entered 
data. 

DA  Device  Acknowledgment  -  Sent  in  response  to  a  Device 
Query  message  when  processing  is  complete. 

ER  Error  Report  -  Sent  when  an  error  is  detected  -  Contains 
information  about  the  error. 

DE  Device  Enable  -  Sent  during  initialization  -  Specifies 
the  characteristics  of  the  newly  started  Virtual 
Terminal . 

AB  Abort  -  Sent  when  an  unrecoverable  error  is  detected  - 
Contains  information  about  the  error. 

FE  Forwarded  Error  -  Sent  in  response  to  a  Signal  Error 
message  -  Contains  the  contents  of  the  Signal  Error 
message. 
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3. 1.2. 2. 2. 2  Slave  Mode  Device  Driver  Messages 
Received  Messages 

DE  Device  Enable  -  Initialize  Virtual  Terminal  for  device 
contained  in  message. 

SD  Shutdown  -  Terminate  Virtual  Terminal. 

DD  Device  Data  -  Process  Virtual  Terminal  commands 
contained  in  message. 


Sent  Messages 

ER  Error  Report  -  Sent  when  an  error  is  detected  -  Contains 
information  about  the  error. 

DI  Device  Initiation  -  Sent  during  initialization  - 

Specifies  the  characteristics  of  the  newly  started 
Virtual  Terminal. 

AB  Abort  -  Sent  when  an  unrecoverable  error  is  detected  - 
Contains  information  about  the  error. 


3. 1.2. 2. 3  Terminal  User 

When  invoking  a  master  mode  Device  Driver,  the  user  can 
specify  a  number  of  parameters  on  the  command  line  to  enable 
optional  processing.  Available  options  include  reading  and 
writing  script  files,  saving  output,  and  screen  printing. 
Scripting  is  actually  performed  by  the  User  Interface;  the  Device 
Driver  is  responsible  only  for  requesting  it.  The  options  are 
specified  as  follows: 

-w  <script  file  name>  -  write  script  file 

-a  <script  file  name>  -  append  to  existing  script  file 

-r  <script  file  name>  -  read  script  file 

-s  <save  file  name>  -  saves  output  from  session 

-p  -  print  every  screen 

The  -r,  -w,  and  -a  options  are  mutually  exclusive. 


3. 1.2. 2. 4  Application  Program 

Application  programs  normally  interface  with  the  User 
Interface  rather  than  the  Virtual  Terminal,  but  a  set  of 
Application  Interface  routines  are  provided  for  special  situations 
where  a  direct  interface  is  required.  An  application  program 
using  this  direct  interface  must  call  the  Virtual  Terminal 
initialization  (INITVT)  and  termination  (TERMVT)  routines  to 
bypass  the  Form  Processor.  Since  INITVT  and  TERMVT  merely  toggle 
Form  Processor  bypass  mode,  INITFP  and  TERMFP  must  be  still  be 
called  at  the  beginning  and  end  of  the  application  as  illustrated 
by  the  sample  COBOL  program  in  Figure  2-3. 
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3. 1.2. 2. 5  Virtual  Terminal  Protocol 

The  Virtual  Terminal  Protocol  consists  of  the  control 
functions  specified  in  Appendix  A.  These  control  functions  are 
defined  in  terms  of  the  ASCII  character  set  but  are  actually 
represented  in  the  local  host  character  set.  Mappings  of  the  most 
common  character  sets  are  specified  in  Appendix  B. 

Each  control  function  is  represented  in  one  of  three  ways:  as 
a  control  character,  an  escape  sequence,  or  a  control  string.  The 
control  characters  are  those  from  0  to  31  and  127;  their  meanings 
are  as  specified  by  [1]  and  [5].  The  general  form  of  escape 
sequences  is  given  in  [2]  and  [6]  with  specific  meanings  assigned 
in  [3]  and  [7].  Control  strings  are  also  defined  in  ^3]  and  [7]. 
In  the  remainder  of  this  document  control  functions  will  be 
referred  to  by  name  or  by  their  standard  acronyms  enclosed  in 
angle  brackets  (e.g.  <CR>) .  Characters  will  be  referred  to  by 
name,  acronym,  and/or  decimal  value  as  appropriate. 

+ - + 

1  APPLICATION  PROGRAM 


PROCEDURE  DIVISION. 

CALL  "INITFP''. 


CALL  "INITVT”. 

CALL  ''PUTVTI"  USING  COMMANDS,  COMMAND-LEN. 

CALL  "GETVTI"  USING  BUFFER,  BUF-SIZE,  BUF-LEN. 


CALL  "TERMVT". 


CALL  "INITVT". 


CALL  "TERMVT". 


I  CALL  "TERMFP" . 

+ - + 

Figure  3-2  Sample  COBOL  Program  Using  Direct  Interface 
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The  general  format  of  an  escape  sequence  is  the  <ESC> 
character  (27) ,  zero  or  more  intermediate  characters  in  the  range 
32  to  47,  and  a  final  character  in  the  range  48  to  126.  The 
general  format  of  a  control  string  is  an  opening  delimiter,  a 
string  of  graphic  characters  and  spaces  (the  range  32  to  126) ,  and 
a  closing  delimiter.  The  control  strings  fall  into  two  classes: 
software  control  strings  and  control  sequence  functions.  The 
software  control  string  begins  with  <APC>  and  ends  with  <ST>. 

The  general  format  of  a  control  sequence  function  is  the 
<CSI>  escape  sequence,  a  parameter  string  consisting  of  zero  or 
more  characters  in  the  range  48  to  63,  zero  or  more  intermediate 
characters  in  the  range  32  to  47,  and  a  final  character  in  the 
range  64  to  126.  A  parameter  string  consists  of  zero  or  more 
parameters  separated  by  semicolons  (59) .  Each  parameter  consists 
of  characters  in  the  range  48  to  57  which  are  interpreted  as  the 
digits  0  through  9.  Parameters  are  interpreted  as  decimal 
integers;  leading  zeros  are  not  significant  and  may  be  omitted.  A 
zero  length  parameter  or  one  consisting  only  of  zeros  represents  a 
default  value.  Trailing  zero  parameters  may  be  omitted,  as  may 
their  separators. 

There  are  two  types  of  parameters:  numeric  parameters  are 
used  for  passing  numeric  values,  selective  parameters  are  used  to 
select  particular  entries  from  a  list.  The  form  of  both  types  is 
the  same.  Although  there  are  no  standardized  functions  which 
require  both  numeric  and  selective  parameters,  the  colon  (58)  has 
been  reserved  for  use  as  the  separator  between  numeric  and 
selective  parameters. 


3 . 2  Detailed  Functional  Requirements 

In  order  to  allow  the  code  to  be  as  portable  and  reusable  as 
possible,  functions  are  separated  into  Class  Routines,  Device 
Routines,  and  System  Routines.  Devices  Routines  are  those  that 
are  applicable  to  a  particular  type  of  terminal,  regardless  of  the 
host  operating  system.  System  Routines  are  those  that  are 
applicable  to  a  particular  operating  system,  regardless  of  the 
type  of  terminal.  Class  Routines  are  those  that  are  applicable  to 
a  large  class  of  terminals  and  operating  systems  (e.g.  the 
routines  that  support  window  management  on  non-windowing  terminals 
and  operating  systems) . 


3.2.1  Application  Interface  Routines 


These  routines  are  responsible  for  initiating,  terminating, 
and  communicating  with  a  Device  Driver  being  run  as  a  separate 
process;  they  form  the  Application  Program  side  of  the 
communication  link  to  the  Device  Driver. 
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3. 2. 1.1  Initialize  Virtual  Terminal 

Initialize  virtual  Terminal  (INITVT)  performs  all  necessary 
initialization  in  preparation  for  using  the  Virtual  Terminal  and 
puts  the  Form  Processor  in  bypass  mode. 

Calling  Sequence 

CALL  "INITVT”. 


3. 2. 1.2  Get  Virtual  Terminal  Data 

Get  Virtual  Terminal  Data  (GETVTI)  accepts  user  input, 
converts  that  input  from  a  device  specific  form  to  a  neutral  form, 
and  returns  the  neutral  form  data  to  the  caller.  All  user  input 
is  accumulated  until  a  function  key  is  pressed.  The  returned  data 
consists  of  a  formatted  buffer  of  the  screen  contents.  The  buffer 
consists  of  a  Set  Window  command  followed  by  Define  Field  commands 
for  each  field  in  the  window  which  has  been  modified  since  the 
last  read.  This  is  followed  by  additional  Set  Window  and  Define 
Field  commands  for  nested  windows.  Finally,  a  Cursor  Position 
Report  command  giving  the  cursor  position  when  the  terminating 
function  key  was  pressed  and  an  Application  Program  Command 
command  specifying  which  function  key  was  pressed  terminate  the 
buffer. 

Calling  Sequence 

CALL  "GETVTI"  USING  BUFFER,  MAX-LEN,  ACT-LEN. 

Inputs 

MAX-LEN  -  binary  -  Maximum  length  to  read. 

Outputs 

BUFFER  -  character  -  Data  read  from  terminal. 

ACT-LEN  -  binary  -  Length  of  data  read. 


3. 2. 1.3  Put  Virtual  Terminal  Data 

Put  Virtual  Terminal  Data  (PUTVTI)  converts  the  supplied 
neutral  form  data  to  device  specific  data  and  displays  it  to  the 
user.  The  supplied  data  may  contain  any  of  the  Virtual  Terminal 
commands . 

Calling  Sequence 

CALL  "PUTVTI"  USING  BUFFER,  ACT-LEN. 

Inputs 

BUFFER  -  character  -  Data  to  be  written. 

ACT-LEN  -  binary  -  Length  of  data  to  write. 
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3.2. 1.4  Terminate  Virtual  Terminal 

Terminate  Virtual  Terminal  (TERMVT)  performs  all  necessary 
clean-up  operations  and  terminates  use  of  the  Virtual  Terminal  by 
disabling  Form  Processor  bypass  mode. 

Calling  Sequence 

CALL  "TERMVT". 

3.2.2  Virtual  Terminal  Monitor 


This  module  is  responsible  for  message  processing.  Messages 
received  from  the  User  Interface  are  processed  as  specified  in 
section  3. 1.2. 2. 2.  If  a  message  contains  Virtual  Terminal 
commands,  they  are  passed  on  to  lower  level  modules  for  device  and 
system  specific  processing.  The  lower  level  routines  called  by 
the  monitor  are  described  in  the  following  sections. 


3. 2. 2.1  Initialize  Lower  Levels 

This  routine  is  called  to  allow  the  lower  level  routines  to 
perform  any  necessary  initialization  and  to  get  information  about 
the  size  and  capabilities  of  the  terminal. 

Calling  Sequence 

CALL  "INTVT"  USING  NAME,  LEN,  SIZ,  GRF,  SURF,  COLORS. 

Inputs 

NAME  -  Terminal  Name  (ignored  in  master  mode) 

LEN  -  Length  of  NAME  (0  if  null  terminated) 

Outputs 

SIZE  -  Width  and  Depth  of  Terminal  in  Character  Cells 
GRF  -  Terminal  Supports  Graphics  (0  or  1) 

SURF  -  Width  and  Depth  of  Terminal  in  Graphic  Pixels 
COLORS  -  Number  of  Colors  Terminal  Supports 

Returns 

Zero  for  failure,  nonzero  for  success. 

3. 2. 2. 2  Terminate  Lower  Levels 

This  routine  is  called  to  allow  the  lower  level  routines  to 
perform  any  necessary  cleanup  prior  to  termination. 

Calling  Sequence 

CALL  "TRMVT". 
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3. 2. 2. 3  Put  Data  to  Lower  Levels 

This  routine  is  called  to  send  Virtual  Terminal  commands  to 
the  lower  level  routines  for  processing. 

Calling  Sequence 

CALL  "PUTVT''  USING  BUFFER,  LEN. 

Inputs 

BUFFER  -  Buffer  of  Virtual  Terminal  Commands 
LEN  -  Length  of  BUFFER 

Returns 

Zero  for  failure,  nonzero  for  success. 

3. 2. 2. 4  Get  Data  from  Lover  Levels 

This  routine  is  called  to  allow  the  lower  level  routines  to 
process  user  input  and  to  retrieve  any  resulting  Virtual  Terminal 
commands . 

Calling  Sequence 

CALL  "GETVT"  USING  BUFFER,  SIZE. 

Inputs 

SIZE  -  Size  of  BUFFER 
Outputs 

BUFFER  -  Buffer  of  Virtual  Terminal  Commands 
Returns 

Length  actually  used  in  BUFFER. 

3. 2. 2. 5  Check  for  Terminal  Input 

This  routine  is  called  to  determine  if  GETVT  should  be  called 
to  process  input. 

Calling  Sequence 

CALL  "TRMCHK". 

Returns 

Number  of  input  characters  pending  (zero  /  nonzero  is 
sufficient) . 
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3.2.3  Class  Routines 


Class  Routines  are  those  which  are  applicable  to  a  variety  of 
systems  and  devices.  By  convention,  these  routines  are  given 
names  ending  with  ”VT'' .  Class  Routines  include  the  window  manager 
for  systems  and  devices  which  do  not  have  windowing  capabilities 
and  the  block  mode  simulator. 

The  window  manager  maintains  a  data  structure  representing 
the  hierarchy  of  windows,  views,  fields,  and  primitives  which  is 
defined  and  modified  by  Virtual  Terminal  commands.  The  final 
display  image  is  determined  by  traversing  this  data  structure  and 
determining  the  visibility  of  each  element.  Similarly,  the  data 
structure  is  traversed  when  an  input  request  is  satisfied  in  order 
to  build  the  appropriate  sequence  of  Virtual  Terminal  commands  to 
be  returned. 

The  block  mode  emulator  is  an  adjunct  to  the  window  manager 
which  allows  an  interactive  terminal  to  work  like  a  field 
structured  block  mode  terminal.  The  emulator  gets  commands  from 
the  Device  Routines  and  interprets  them.  Cursor  positioning 
commands  are  examined  in  order  to  keep  track  of  the  current 
position  in  the  window  manager  data  structure.  Printable 
characters  are  inserted  into  the  structure  and  displayed  on  the 
screen  at  the  correct  location. 

The  window  manager  and  block  mode  emulator  provide  the  INIVT, 
TRMVT,  GETVT,  and  PUTVT  routines  required  by  the  monitor.  They 
reference  the  Device  Routines  described  in  the  following  sections. 


3. 2. 3.1  Initialize  Terminal 

This  routine  is  called  to  allow  the  Device  Routines  to 
perform  any  necessary  initialization. 

Calling  Sequence 

CALL  "TRMINI"  USING  NAME. 

Inputs 

NAME  -  Terminal  Name  (null  terminated) 

Returns 

Zero  for  failure,  nonzero  for  success. 


3 . 2 . 3 . 2  Terminate  Terminal 

This  is  called  to  allow  the  Device  Routines  to  perform  any 
necessary  cleanup  prior  to  termination. 

Calling  Sequence 

CALL  ''TRMEND''. 
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3. 2. 3. 3  Get  Terminal  Command 

This  routine  is  called  to  get  a  Virtual  Terminal  command  from 
the  Device  Routines. 

Calling  Sequence 

CALL  "TRMGET"  USING  CMD. 

Outputs 

CMD  -  Virtual  Terminal  Command 
Returns 

Zero  for  failure,  nonzero  for  success. 

3. 2. 3. 4  Put  Terminal  Command 

This  routine  is  called  to  pass  a  Virtual  Terminal  command  to 
the  Device  Routines  for  execution. 

Calling  Sequence 

CALL  "TRMPUT”  USING  CMD. 

Inputs 

CMD  -  Virtual  Terminal  Command 

3. 2. 3. 5  Flush  Terminal  Buffer 

This  routine  is  called  to  flush  any  buffers  the  Device 
Routines  may  have  and  complete  any  deferred  actions  to  ensure  that 
the  screen  image  is  up  to  date. 

Calling  Sequence 

CALL  ''TRMFLS”. 


3.2.4  Device  Routines 


Device  Routines  are  responsible  for  mapping  between  device 
specific  commands  and  Virtual  Terminal  commands.  By  convention, 
these  routines  are  given  names  beginning  with  "TRM"  and  all 
routines  for  a  single  terminal  reside  in  the  same  file. 
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3.2.5  System  Routines 

System  Routines  are  used  by  the  Device  Routines  to 
communicate  with  a  physical  terminal.  For  block  mode  emulation, 
the  system  routines  must  provide  a  mechanism  for  reading 
individual  characters  as  '.-hey  are  entered  without  echoing  the 
characters  to  the  screen. 


3 . 3  Performance  Requirements 
3.3.1  Programming  Methods 

The  Virtual  Terminal  is  implemented  as  a  number  of  Device 
Drivers;  the  correct  Device  Driver  for  a  particular  terminal  is 
selected  at  run-time.  Dividing  the  routines  into  Device,  System, 
and  Class  routines  allows  for  sharing  much  of  the  actual  Device 
Driver  code.  Different  devices  on  the  same  system  can  share  the 
System  and  Class  routines.  The  same  device  on  different  systems 
can  share  Device  and  Class  routines.  Similar  systems  share  Class 
routines.  This  system  of  sharable  and  reusable  code  simplifies 
the  process  of  implementing  new  device  drivers. 

All  Class  routines  will  be  written  in  portable  C  for  ease  of 
porting  to  additional  systems.  Device  routines  will  also  be 
written  in  portable  C  with  the  possible  exception  of  devices  which 
are  intimately  tied  to  a  particular  system.  System  routines  will 
be  written  in  the  language  most  suited  to  interacting  with  the 
host  operating  system. 


3.3.2  Program  Organization 

The  program  organization  is  as  specified  in  section  3.2. 


3.3.3  Modification  Consideration 


Modification  considerations  were  a  major  consideration  in  the 
decision  to  use  the  structure  specified  in  section  3.2.  Isolating 
Device  Routines  allows  installation  specific  changes  (e.g. 
alternate  keyboard  mappings)  to  be  made  conveniently  since  the 
affected  module  is  easily  located.  Further  modification  such  as 
new  devices  or  systems  is  also  facilitated  by  the  large  number  of 
reusable  routines. 


3.3.4  Special  Features 

The  design  is  such  that  the  monitor  may  be  easily  replaced 
during  testing  with  an  equivalent  module  which  allows  the  lower 
level  routines  to  be  linked  directly  to  the  User  Interface.  This 
aids  in  fault  isolation  and  diagnosis  by  eliminating  the 
dependency  upon  the  Network  Transaction  Manager. 
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3.3.5  Expansibility 

Since  the  Virtual  Terminal  is  implemented  as  Device  Drivers, 
it  may  be  expanded  to  support  any  number  of  device  types  by 
implementing  new  Device  Drivers.  Separating  functions  into 
Device,  System,  and  Class  routines  aids  in  this  process  by 
insuring  that  reusable  routines  can  be  easily  identified. 


3 . 4  Adaptation  Requirements 

Adapting  the  Virtual  Terminal  for  use  on  other  systems 
requires  modification  to  or  replacement  of  the  System  Routines. 
Adaptation  for  use  with  other  terminal  requires  creation  of  new 
Device  Routines. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


Testing  is  a  systematic  process  that  may  be  preplanned  and 
explicitly  stated.  Test  techniques  and  procedures  may  be  defined 
in  advance  and  a  sequence  of  test  steps  may  be  specified. 
Debugging  is  the  process  of  isolation  and  correction  of  the  cause 
of  an  error. 

Antibugging  is  defined  as  the  philosophy  of  writing  programs 
in  such  a  way  as  to  make  bugs  less  likely  to  occur  and  when  they 
do  occur,  to  make  them  more  noticeable  to  the  programmer  and  the 
user.  In  other  words,  as  much  error  checking  as  is  practical  and 
possible  in  each  routine  should  be  performed. 


4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consist  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These  tests 
are  performed  by  the  design  team.  Structured  design,  design 
walk-through  and  the  incorporation  of  antibugging  facilitate  this 
testing  by  exposing  and  addressing  problem  areas  before  they 
become  coded  bugs. 

The  integration  testing  entails  use  of  a  test  application  of 
the  VAX.  This  test  program  will  display  forms,  read  input  from 
forms,  and  display  results. 

Each  function  is  be  tested  separately,  then  the  entire 
subsystem  is  tested  as  a  unit.  All  testing  is  done  on  the  IISS 
testbed. 
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SECTION  5 

PREPARATION  FOR  DELIVERY 

The  implementation  site  for  the  constructed  software  is  the 
Integrated  Support  System  Test  Bed  site  provided  by  the  Air  Force. 
The  software  associated  with  each  CPCI  release  is  delivered  on  a 
media  which  is  compatible  with  the  IISS  Test  Bed.  The  release  is 
clearly  identified  and  includes  instructions  on  procedures  to  be 
followed  for  installation  of  the  release.  Integration  with  the 
other  IISS  CPCI's  is  done  on  the  IIS.S  testbed  on  a  scheduled 
basis. 
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APPENDIX  A 

VIRTUAL  TERMINAL  COMMAND  DESCRIPTIONS 


The  format  of  the  following  command  descriptions  is  the 
control  function  acronym  and  name,  the  command  syntax,  and  a 
detailed  description  of  the  command.  In  the  command  syntax, 
characters  within  angle  brackets  (e.g.  <ESC>)  indicate  other 
control  functions,  Pn  indicates  a  Numeric  Parameter,  Ps  indicates 
a  Selective  Parameter,  and  all  other  characters  stand  for  them¬ 
selves.  Unless  specified  otherwise.  Numeric  Parameters  indicate 
the  number  of  times  to  repeat  the  specified  function,  omitted 
Numeric  Parameters  are  taken  to  be  1,  and  omitted  Selective 
Parameters  are  taken  to  be  0. 

The  Virtual  Terminal  screen  consists  of  X  rows  numbered  from 
1  to  X,  and  Y  columns  numbered  from  1  to  Y.  The  standard  ordering 
of  objects  is  from  top  to  bottom  and  left  to  right,  with 
wrap-around  from  the  last  object  to  the  first.  "Next"  in  the 
command  descriptions  refers  to  this  order,  "previous"  to  its 
reverse.  For  example  (if  Y=80) ,  from  row  6  column  80,  the  next 
character  position  is  row  7  column  1,  and  the  previous  character 
position  is  row  6  column  79. 

Any  command  whose  effect  is  limited  to  a  single  field 
(including  Graphic  Characters)  causes  the  cursor  to  move  to  the 
next  unprotected  field  before  the  command  takes  effect  if  the 
cursor  is  in  a  protected  field  when  the  command  is  received.  If 
there  are  no  unprotected  fields  defined,  the  command  is  ignored. 

Each  window  is  assigned  a  coordinate  system  ranging  from  0  to 
65535  in  both  X  and  Y.  This  coordinate  system  is  used  only  for 
setting  the  window's  viewport.  Each  viewport  is  also  assigned  a 
coordinate  system  ranging  from  0  to  65535  in  both  X  and  Y.  All 
graphic  primitives  are  specified  in  viewport  coordinates. 


Control  Characters 


BEL  -  Sound  Bell 
<BEL> 

Sounds  an  audible  alarm  at  the  terminal. 

BS  -  Backspace 
<BS> 

Moves  the  cursor  to  the  previous  character  position.  If  the 
cursor  is  at  the  first  column,  it  is  moved  to  the  last  column  of 
the  previous  line  or  the  bottom  line  if  the  cursor  was  on  the  top 
line . 

HT  -  Horizontal  Tab 
<HT> 

Moves  the  cursor  to  the  next  field. 


A-1 


DS  620344300 
30  September  1990 


LF  -  Line  Feed 
<LF> 

Moves  the  cursor  down  to  the  next  line  in  the  current  column.  If 
the  cursor  is  at  the  bottom  line  of  the  screen,  it  is  moved  to  the 
next  column  in  the  top  line  or  the  first  column  in  the  cursor  was 
in  the  last  column. 

FF  -  Form  Feed 
<FF> 

Erases  all  unprotected  fields  on  the  screen  and  moves  the  cursor 
to  the  top  left  corner  of  the  screen. 

CR  -  Carriage  Return 
<CR> 

Moves  the  cursor  backward  to  the  beginning  of  the  previous  field. 

RS  -  Record  Separator 
<RS> 

Causes  the  screen  to  be  updated.  To  improve  efficiency,  commands 
are  not  necessarily  executed  when  received.  This  command  is  given 
at  the  end  of  a  series  of  commands  to  force  any  pending  actions  to 
be  completed. 

US  -  Unit  Separator 
<US> 

Causes  the  screen  to  be  remapped.  To  improve  efficiency,  the 
mapping  between  fields  and  characters  on  the  screen  is  not  updated 
with  every  change.  This  command  is  given  at  the  end  of  a  series 
of  format  changes  to  enable  remapping. 

SP  -  Space 
<SP> 

Treated  as  a  graphic  character. 


Graphic  Characters 

Causes  the  specified  character  to  be  displayed  according  to 
the  field  attributes  in  effect  at  the  cursor  location  and  advances 
the  cursor  to  the  next  character  position. 


Extended  Control  Characters  /  Escape  Sequences 

REF  -  Refresh  Screen 
<ESC>  ? 

Retransmits  the  current  screen  contents  to  the  terminal.  Its  main 
uses  are  to  recover  from  unsolicited  messages  or  line  noise  which 
have  corrupted  the  screen  contents. 

IND  -  Index 
<IND> 

<ESC>  D 

Same  as  Line  Feed. 
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NEL  -  Next  Line 
<NEL> 

<ESC>  E 

Moves  the  cursor  to  the  beginning  of  the  next  line  of  the  current 
field  or  the  first  line  of  the  next  field  if  the  cursor  is  on  the 
last  line  of  a  field. 

RI  -  Reverse  Index 
<RI> 

<ESC>  M 

Moves  the  cursor  up  to  the  previous  line  in  the  current  column. 

If  the  cursor  is  on  the  top  line  of  the  screen  it  is  moved  to  the 
last  line  in  the  previous  column  or  the  last  column  if  the  cursor 
was  in  the  first  column. 

CEL  -  Cursor  End  of  Line 
<ESC>  Q 

Moves  the  cursor  to  the  end  of  the  next  line  of  the  current  field 
or  the  first  line  of  the  next  field  if  the  cursor  is  at  the  end  of 
the  last  line  of  a  field. 

STS  -  Set  Transmit  State 
<STS> 

<ESC>  S 

Enables  the  currently  selected  window  and  all  its  contained 
subwindows  for  input.  All  unguarded  fields  are  made  enterable  and 
a  data  message  will  be  sent  when  a  function  key  is  pressed.  The 
data  message  contains  a  Select  Window  command  for  each  window 
which  has  been  modified.  Each  Define  Window  command  is  followed 
by  Define  Field  commands  for  each  contained  modified  field 
(including  the  field  data)  and  Define  Window  commands  for  each 
contained  modified  window.  Following  all  of  these  commands  is  a 
Cursor  Position  Report  command  giving  the  cursor  position  when  the 
function  key  was  pressed  and  an  Application  Program  Command 
specifying  the  function  key. 

CSI  -  Control  Sequence  Introducer 
<CSI> 

<ESC>  [ 

Indicates  the  beginning  of  a  Control  Sequence. 

ST  -  String  Terminator 
<ST> 

<ESC>  \ 

Terminates  an  Application  Program  Command. 

APC  -  Application  Program  Command 
<APC> 

<ESC> 

Generated  when  a  function  key  is  pressed.  This  command  is 
followed  by  the  function  key  number  (0  -  N)  and  a  String 
Terminator.  Function  key  zero  is  the  "ENTER"  key. 

RIS  -  Reset  to  Initial  State 
<ESC>  c 

Resets  the  terminal  to  its  initial  state.  The  screen  is  cleared, 
the  cursor  is  positioned  in  the  upper  left  corner. 
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Control  Sequences 

ICH  -  Insert  Character 
<CSI>  Pn  @ 

Makes  room  for  a  character  by  shifting  the  current  and  following 
characters  of  the  field  one  character  position  to  the  right; 
characters  shifted  past  the  end  of  the  field  are  lost.  The  cursor 
is  left  at  the  first  inserted  character  position  (i.e.  not  moved). 

CUU  -  Cursor  Up 
<CSI>  Pn  A 

Same  as  Reverse  Index. 

CUD  -  Cursor  Down 
<CSI>  Pn  B 
Same  as  Line  Feed. 

CUF  -  Cursor  Forward 
<CSI>  Pn  C 

Moves  the  cursor  to  the  next  character  position.  If  the  cursor  is 
in  the  last  column  it  is  moved  to  the  first  column  of  the  next 
line  or  the  first  line  if  the  cursor  was  in  the  last  line. 

CUB  -  Cursor  Backward 
<CSI>  Pn  D 

Moves  the  cursor  to  the  previous  character  position.  If  the 
cursor  is  in  the  first  column  it  is  moved  to  the  last  column  of 
the  previous  line  or  the  last  line  if  the  cursor  was  on  the  top 
line. 

CNL  -  Cursor  Next  Line 
<CSI>  Pn  E 
Same  as  Next  Line. 

CPL  -  Cursor  Previous  Line 
<CSI>  Pn  F 

Moves  the  cursor  to  the  beginning  of  the  previous  line  of  the 
field  or  the  previous  field  if  the  cursor  was  at  the  beginning  of 
a  field. 

CUP  -  Cursor  Position 
<CSI>  Pn  ;  Pn  H 

Moves  the  cursor  to  the  specified  position.  The  first  parameter 
is  the  row  number,  the  second  parameter  is  the  column  number. 

CHT  -  Cursor  Horizontal  Tab 
<CSI>  Pn  I 

Same  as  Horizontal  Tab. 

ED  -  Erase  Display 
<CSI>  Ps  J 

Erases  unprotected  fields  on  the  screen  according  to  the 
parameter: 

0  -  Erase  from  the  cursor  to  the  end  of  the  screen 
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1  -  Erase  from  the  beginning  of  the  screen  to  the  cursor 

2  -  Erase  the  entire  screen 
The  cursor  is  not  moved. 

EL  -  Erase  Line 
<CSI>  Ps  K 

Erases  unprotected  fields  on  the  current  line  according  to  the 
parameter: 

0  -  Erase  from  the  cursor  to  the  end  of  the  line 

1  -  Erase  from  the  beginning  of  the  line  to  the  cursor 

2  -  Erase  the  entire  line 
The  cursor  is  not  moved. 

IL  -  Insert  Line 
<CSI>  Pn  L 

Makes  room  for  a  line  by  shifting  the  current  and  following  line 
of  the  field  down  one  line;  lines  shifted  past  the  bottom  of  the 
field  are  lost.  The  cursor  is  positioned  at  the  first  inserted 
line  (i.e.  not  moved). 

DL  -  Delete  Line 
<CSI>  Pn  M 

Deletes  the  current  line  by  shifting  the  following  lines  of  the 
field  up  one  line. 

EF  -  Erase  Field 
<CSI>  Ps  N 

Erases  the  current  field  according  to  the  parameter: 

0  -  Erase  from  the  cursor  to  the  end  of  the  field 

1  -  Erase  from  the  beginning  of  the  field  to  the  cursor 

2  -  Erase  the  entire  field 
The  cursor  is  not  moved. 

DCH  -  Delete  Character 
<CSI>  Pn  P 

Deletes  the  current  character  by  shifting  the  following  characters 
of  the  field  one  character  position  to  the  left. 

CPR  -  Cursor  Position  Report 
<CSI>  Pn  ;  Pn  R 

Indicates  the  current  position  of  the  cursor. 

NR  -  Next  Page 
<CSI>  Pn  U 
Same  as  Form  Feed. 

PP  -  Previous  Page 
<CSI>  Pn  V 
Same  as  Form  Feed. 

ECH  -  Erase  Character 
<CSI>  Pn  X 

Erases  the  specified  number  of  characters  starting  at  the  current 
character  (the  characters  are  NOT  deleted) .  The  cursor  is  not 
moved . 
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CBT  -  Cursor  Backward  Tab 
<CSI>  Pn  Z 

Moves  the  cursor  to  the  previous  field. 

HPA  -  Horizontal  Position  Absolute 
<CSI>  Pn 

Moves  the  cursor  to  the  specified  column  in  the  current  line.  If 
the  specified  position  is  beyond  the  last  column  the  cursor  is 
moved  to  the  first  column  of  the  next  line  or  the  first  line  if 
the  cursor  was  in  the  last  line. 

HPR  -  Horizontal  Position  Relative 
<CSI>  Pn  a 

Same  as  Cursor  Forward. 

VPA  -  Vertical  Position  Absolute 
<CSI>  Pn  d 

Moves  the  cursor  to  the  specified  line  in  the  current  column.  If 
the  specified  position  is  beyond  the  last  row  the  cursor  is  moved 
to  the  next  column  in  the  first  line  or  the  first  column  if  the 
cursor  was  in  the  last  column. 

VPR  -  Vertical  Position  Relative 
<CSI>  Pn  e 
Same  as  Line  Feed. 

HVP  -  Horizontal  and  Vertical  Position 
<CSI>  Pn  ;  Pn  f 
Same  as  Cursor  Position. 

SM  -  Set  Mode 

<CSI>  Ps  h 

Sets  the  indicated  mode: 

4  -  Insertion  -  Replacement  (Insert) 

MC  -  Media  Copy 
<CSI>Ps  i 

Controls  the  transfer  of  data  between  the  device  and  an  auxiliary 
input/output  device; 

0  -  Print  Screen 

RM  -  Reset  Mode 
<CSI>  Ps  1 

Resets  the  indicated  modes: 

4  -  Insertion  -  Replacement  (Replacement) 

WP  -  Set  Window  Precedence 
<CSI>  Pn  ;  ...  p 

Sets  the  precedence  of  the  specified  windows.  Each  is  in  turn 
placed  on  top  of  all  other  existing  windows.  Thus,  the  last 
window  specified  will  ultimately  be  the  top-most,  and  all 
specified  windows  will  be  on  top  of  any  unspecified  windows. 

RW  -  Remove  Window 
<CSI>  Pn  r 

Removes  the  window  from  the  screen. 
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SW  -  Select  Window 
<CSI>  Pn  s 

Selects  the  specified  window.  If  the  parameter  is  zero  or 
omitted,  the  device  itself  is  selected. 

EW  -  Erase  Window 
<CSI>  Pn  u 

Removes  all  subwindows,  fields,  and  graphic  primitives  from  the 
specified  subwindow  of  the  currently  selected  window.  If  the 
parameter  is  zero  or  omitted,  the  currently  selected  window  itself 
is  erased. 

DV  -  Define  Viewport 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  v 

Sets  the  graphic  viewport  of  the  currently  selected  window.  The 
viewport  is  assigned  a  virtual  coordinate  system  extending  from  0 
to  65535  in  both  X  and  Y.  Graphic  primitives  are  specified  in 
viewport  coordinates  and  thus  are  completely  contained  within  the 
viewport  at  all  times.  When  a  window  is  created,  the  viewport  is 
set  to  the  entire  window  ( 0  ;  0 ; 65535 ; 65535) .  The  numeric  param¬ 
eters  are  the  X  and  Y  window  coordinates  of  the  lower  left  corner 
of  the  viewport  and  the  X  and  Y  window  coordinates  of  the  upper 
right  corner  of  the  viewport. 

DW  -  Define  Window 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  :  Ps  w 
Defines  or  modifies  a  subwindow  of  the  currently  selected  window. 
The  numeric  parameters  are  the  window  ID,  the  row  within  the 
parent  window,  the  column  within  the  parent  window,  the  displayed 
width,  the  displayed  depth,  the  number  of  rows  the  display  is 
offset,  the  number  of  columns  the  display  is  offset,  the  logical 
width,  and  the  logical  depth.  The  selective  parameter  is  the 
attributes  for  the  window: 

40  -  Black  Background 

41  -  Red  Background 

42  -  Green  Background 

43  -  Yellow  Background 

44  -  Blue  Background 

45  -  Magenta  Background 

46  -  Cyan  Background 

47  -  White  Background 

30  -  Black  Foreground 

31  -  Red  Foreground 

32  -  Green  Foreground 

33  -  Yellow  Foreground 

34  -  Blue  Foreground 

35  -  Magenta  Foreground 

36  -  Cyan  Foreground 

37  -  White  Foreground 

Omitted  parameters  indicate  no  change  to  the  existing  values. 

(Note  that  the  foreground  color  is  used  to  determine  whether  the 
window  appears  in  normal  or  reverse  video  on  monochrome 
terminals. ) 

DF  -  Define  Field 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  :  Ps  ;  Ps  x 
Defines  or  modifies  a  field  in  the  currently  selected  window.  The 
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numeric  parameters  are  the  row  within  the  parent  window,  the 
column  within  the  parent  window,  the  display  width,  and  the 
display  depth.  The  first  selective  parameter  is  the  "guarded" 
flag  which  must  consist  of  exactly  one  selection  from  the 
following  list: 

0  -  Field  is  enterable 
1  -  Field  is  guarded 

The  second  selective  parameter  is  the  attributes  for  the  field: 

0  -  Normal  (Remove  any  existing  attributes) 

1  -  Bright  or  Bold 

2  -  Dim 

4  -  Underlined 

5  -  Slow  Blink  (less  than  150  per  minute) 

6  -  Fast  Blink  (more  than  150  per  minute) 

7  -  Reverse 

8  -  Concealed  (not  displayed) 

30  -  Black  Foreground 

31  -  Red  Foreground 

32  -  Green  Foreground 

33  -  Yellow  Foreground 

34  -  Blue  Foreground 

35  -  Magenta  Foreground 

36  -  Cyan  Foreground 

37  -  White  Foreground 

40  -  Black  Background 

41  -  Red  Background 

42  -  Green  Background 

43  -  Yellow  Background 

44  -  Blue  Background 

45  -  Magenta  Background 

46  -  Cyan  Background 

47  -  White  Background 

Omitted  parameters  indicate  no  change  to  the  existing  values. 

This  command  is  followed  by  the  data  for  the  field.  Trailing 
blanks  in  the  field  data  may  be  omitted. 

DVT  -  Define  View  Text 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  :  Ps  ;  Ps  ;  Ps  ; 
Ps  ;  Pn  "  V 

Adds  a  text  primitive  to  the  currently  selected  view.  The 
parameters  are  the  X  and  Y  viewport  coordinates  of  the  reference 
point,  the  color  index,  the  font  index,  the  spacing  factor,  the 
expansion  factor,  the  height,  the  angle  of  the  up  vector  (0  =  up, 
16384  =  left,  32768  =  down,  49152  =  right) ,  the  precision,  the 
path,  the  vertical  alignment,  the  horizontal  alignment,  and  the 
length  of  the  text  string.  Only  font  1  is  currently  supported. 
Parameters  indicated  as  factors  are  specified  as  a  percentage  of 
the  nominal  value  (omitted  factors  are  taken  to  be  100) .  Valid 
precisions  are: 

0  -  String 
Valid  paths  are: 

0  -  Right 

1  -  Left 

2  -  Up 

3  -  Down 

Valid  vertical  alignments  are: 

0  -  Normal 
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1  -  Top 

2  -  Cap 

3  -  Half 

4  -  Base 

5  -  Bottom 

Valid  Horizontal  alignments  are: 

0  -  Normal 

1  -  Left 

2  -  Center 

3  -  Right 

DVF  -  Define  View  Fill  Area 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  . . .  &  V 

Adds  a  fill  area  primitive  to  the  currently  selected  view.  The 
parameters  are  the  color  index,  interior  style  index,  and  X  and  Y 
viewport  coordinates  of  the  boundary.  Valid  interior  styles  are: 
0  -  Hollow 
1  -  Solid 

4  -  Empty 

DVM  -  Define  View  Markers 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  . . .  *  v 
Adds  a  marker  primitive  to  the  currently  selected  view.  The 
parameters  are  the  color  index,  the  marker  style,  the  marker  size 
factor,  and  the  X  and  Y  viewport  coordinates  of  the  markers.  The 
maker  size  factor  is  specified  as  a  percentage  of  the  nominal 
value.  Valid  maker  styles  are: 

1  -  Point 

2  -  Plus 

3  -  Star 

4  -  Circle 

5  -  Cross 

DVL  -  Define  View  Lines 

<CSI>  Pn  ;  Pn  ;  Pn  ;  Pn  ;  Pn  ...  -  v 
Adds  a  line  primitive  to  the  currently  selected  view.  The 
parameters  are  the  color  index,  the  line  style,  the  line  width 
factor,  and  the  X  and  Y  viewport  coordinates  of  the  points  to  be 
connected.  The  line  width  factor  is  specified  as  a  percentage  of 
the  nominal  value.  Valid  line  styles  are: 

1  -  Solid 

2  -  Dashed 

3  -  Dotted 

4  -  Dashed  Dotted 
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APPENDIX  B 

CHARACTER  SET  MAPPINGS 
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